home *** CD-ROM | disk | FTP | other *** search
/ Amiga Collections: Tampa Bay Amiga Group / TBAG - Tampa Bay Amiga Group's Disk of the Month #04 (1986)(Merlin's Software)(PD).zip / TBAG - Tampa Bay Amiga Group's Disk of the Month #04 (1986)(Merlin's Software)(PD).adf / Doc-Files / Utilities-Doc / DoTil.doc < prev    next >
Text File  |  1986-09-10  |  9KB  |  192 lines
  1. DoTil Revision 1.0   January 8, 1987
  2.  
  3. Directory utilities seem to be a popular item.  Many of us spend a
  4. large proportion of our console time rooting through our disks
  5. trying to maintain some semblance or order.  This means a lot
  6. of typing of obscure file names and directory paths which end
  7. up being wrong more often than not.  DoTil hopes, or at least
  8. pretends, to make those file maintenance chores a little easier.
  9.  
  10. DoTil will list in alphabetical order, all files on any two
  11. directories.  It will show the file size, creation date and
  12. the amount of free disk space.  It will copy, rename and
  13. delete files, create or delete directories and move one or
  14. more files from on directory to another.  It will even do
  15. some of the things it can't do itself using the COMMAND
  16. feature.
  17.  
  18. DoTil can be used to run your editor, and could be used to
  19. run a compiler although it is actually more trouble than
  20. using CLI to do so.  It will not work well with programs
  21. (such as FORMAT) which require entry from the current
  22. standard input, and if run from WorkBench, it doesn't
  23. understand what the 'current' directory is.  Most importantly,
  24. it will not decide what you need to do next.  That remains,
  25. as allways, the user's problem.
  26.  
  27. Most of the program is intuitively obvious like a good Amiga
  28. program should be.  There are some points which require the
  29. inevitable clarifications.
  30.  
  31. Getting Started...
  32.  
  33. Why does all documentation have to contain this tired old
  34. subtitle?  Start the program from WorkBench or CLI.  The
  35. RAM: disk is displayed in both 'windows'.  Notice the
  36. Total and Space Available values.  Total shows the total
  37. size of all files in the current directory, or the total
  38. of all selected files.  Space Available displays the amount
  39. of disk space available on the destination.  This value is
  40. always zero for the RAM: disk.  If your RAM: disk is empty,
  41. select another disk using the gadgets in the lower right hand
  42. corner.  Click on a directory (displayed in orange on 'normal'
  43. systems) and the directory will be loaded and displayed.
  44. Select one file by clicking on it.  Notice that the directory
  45. and file name is shown in the 'source' gadget.  This is
  46. useful when using RENAME.  Now select some more files and
  47. watch the Total value increase.  Copy the files to RAM: by
  48. clicking the COPY gadget in the title bar, or by using the
  49. COPY menu item.  Each file is displayed in the Message space
  50. as it is copied.  The number of files copied will be shown
  51. when the command is complete.  Play with the OPTIONS menu
  52. (all non-destructive) and see the how file dates and times
  53. may be displayed.  The DIR SELECT menu item allows a
  54. directory to be selected rather than loaded.  This is the
  55. only way to delete or rename a directory.  So much for
  56. getting started.
  57.  
  58. DELETE, MAKE DIR, VIEW
  59.  
  60. These functions do not require a 'destination'.  A single
  61. path is all that is needed, obviously.  Only the 'Source'
  62. path is valid for these commands.  This is the main reason
  63. for the WINDOWS menu list.  Want to delete a file on the
  64. 'Destination' to make room for the file you are about to
  65. copy?  You must make that 'window' the 'Source' first using
  66. the SWAP menu item.  Delete the file, and SWAP again.  You
  67. are ready to copy.
  68.  
  69. Manual Input:
  70.  
  71. The Source and Destination string gadgets do not behave in
  72. precisely the same way as in other directory utilities.  They
  73. are used primarily for display.  The only input you should
  74. need (or want) to provide are the names of new directories,
  75. or the new file name when using RENAME.  You may for some
  76. unknown reason be tempted to just type in the destination
  77. path rather than wait for the directory to be loaded using the
  78. gadgets.  Don't bother, it won't work.  Devices and paths
  79. are not normally obtained from the string gadgets, but from
  80. internal variables which are set when the gadgets are used.
  81. This does NOT preclude coping a file to a new name by
  82. entering the new name via the destination gadget.  This will
  83. work just fine.  When in doubt, remember: if you can use the
  84. mouse to select the name you want, do so.  Otherwise type
  85. the new name into the string gadget.
  86.  
  87. Standard Output:
  88.  
  89. DoTil may be run either from WorkBench, or from the CLI.  If the
  90. program is executed from CLI, it will use the CLI window for
  91. standard output.  DoTil itself does not use the standard output
  92. except for a few hopefully never to be seen error messages.
  93. Any program executed using the COMMAND feature (see below) will
  94. use the CLI window just as if it had been run directly from CLI.
  95. If DoTil is run from WorkBench however, a little window is opened
  96. for use as the standard output.  This window will be located behind
  97. DoTil, and must be made visible using the depth gadgets if you want
  98. to see what you are doing.  I had to access some Lattice data
  99. structures (located in _main.c) in order to make this possible.
  100.  
  101. Commands:
  102.  
  103. This lets you EXECUTE the contents of the Command string gadget.
  104. Type in whatever you want and select the Execute menu item.  It
  105. probably won't work because this feature has no notion of what the
  106. 'current' directory is. The complete path must be specified.
  107. The S TO COMMAND and D TO COMMAND menu items allow the Command
  108. string gadget to be filled using the mouse.  Both will concatenate
  109. the contents of the Source or Destination string gadget onto
  110. whatever is already in the Command gadget.  Use it for INFO
  111. or a printer utility.  Don't use it for FORMAT because there
  112. will be NO standard input and you will not be able to
  113. PRESS RETURN TO CONTINUE.
  114.  
  115. Limitations:
  116.  
  117. You can not select files in more than one directory.
  118.  
  119. The size of the 'source' and 'destination' string gadgets will limit
  120. the utility of DoTil if you have very deeply nested directories and/or
  121. very long file names.  This is a design error on my part.  String
  122. gadgets may actually contain more characters than are displayed.
  123. The arrow keys may be used the scroll through the undisplayed text.
  124. I got lazy and didn't want to figure out a way to indicate that all
  125. the text wasn't shown.  This may change in the next version.
  126.  
  127. The VIEW function is a bare-bones routine.  When viewing ASCII
  128. files, it makes an assumption about the size of each text line.
  129. Consequently, the proportional gadget is not entirely accurate.
  130. Clicking in the select box will select the next page, more or
  131. less.  The proper (and time consuming) way to correct this is
  132. to count all the lines in the file before the first page is
  133. displayed.  The proportional gadget could then be positioned
  134. accurately and each click in the select box would produce the
  135. next page, exactly.  The purpose of the VIEW feature is to
  136. allow a quick look at the file you are about to copy or delete.
  137. DoTil is already too big to justify the extra code.
  138.  
  139. My apologies to those of you who are fortunate enough to have a third
  140. diskette or hard disk.  DoTil has left you out in the cold.  The next
  141. version will fix this inexcusable limitation.
  142.  
  143. The GET PARENT menu item should be a gadget.  I just couldn't figure out
  144. where to put it without changing the whole layout.  Once again, next
  145. version.
  146.  
  147. Someone is going to delete a whole bunch of files sometime because the
  148. files stay selected after the command is complete.  I have no intention
  149. of changing this since I believe it is genuinely useful under most
  150. conditions.  It would be easy to delete the wrong files accidently
  151. especially if SWAP is being used and the source and destination
  152. are jumping all over.  If it happens, too bad for you.  I'm sorry and
  153. thats the only consolation you'll have.  The current plan is for the
  154. source and destination 'windows' to stay put in the next version. SWAP
  155. will cause the contents to move instead.  This may cause some problems
  156. of its own, but I find myself staring at the screen sometimes trying
  157. to convince myself that I'm about to do the right thing.  I think
  158. it will help if things don't move around so much.
  159.  
  160. Contributions:
  161.  
  162. I live in a tiny room with no heat.  I work long hours at low wages
  163. to support my sick mother.  I believe in the Amiga and the free
  164. enterprise system.  Please send me the meager sum of $15 for my
  165. efforts in producing a program of genuine utility.  It doesn't
  166. come in a flashing box and the documentation isn't on slick paper
  167. with little tabs but I put my heart into this program.  Please,
  168. send your check or money order to:
  169.  
  170.                Dan Franki
  171.                12306 Tomanet Trail
  172.                Austin, Texas  78758
  173.  
  174. When I have the source in a condition I consider distributable, I will
  175. make it available to all.  DoTil owes a lot to other peoples programs
  176. from which I have borrowed shamelessly.  Send me a disk (and a little
  177. money) if you just can't wait.  
  178.  
  179. Last but not least, this important announcement:
  180.  
  181. DoTil may be freely copied and used by anyone provided that:
  182.  
  183.    The party providing the copy recieves no fee or other
  184.    compensation excluding club membership dues or media charges.
  185.  
  186.    This documentation file is included in its original form.
  187.  
  188. The author makes no claims as to the suitablity or accuracy of
  189. this program.  Any damage resulting from the use of DoTil is
  190. the sole responsibility of the user.
  191.  
  192.